Configuring folder property mapping

Similar to how it replicates documents, the Global Collaboration Framework can also replicate folders. The folders can be normal folders, folders created with custom folder types and customer properties, or project folders. Folders are explicitly replicated when remote vaults are enlisted for them from within PowerUser as described in the BlueCielo Meridian Global Collaboration Framework User's Guide. Folders are also replicated implicitly if a document is enlisted and the document resides in a folder that is not explicitly enlisted. When the document is replicated, the folder will be replicated. You specify the folder properties that are replicated by defining a mapping between briefcase template properties and folder properties.

Note    Folder property replication is only supported by Meridian Enterprise 2011 and higher when using custom briefcase formats. For more information about custom briefcase formats, see the BlueCielo Meridian Enterprise Administrator's Guide.

Note    The folder types and folder properties that are replicated must be configured identically in all collaborating vaults.

To configure folder property mapping:

1. For each folder property that you want to replicate, define a property in the briefcase template that is used by the GCF. For information on configuring briefcase templates, see the BlueCielo Meridian Enterprise Administrator's Guide.
2. Create or edit the FolderSettings setting of the GCF briefcase template. The value of this setting is the name of a section of property mappings, for example, MyFolderSection.
3. On an empty line, create a property mapping section that begins with the value of the FolderSettings setting surrounded by square brackets, for example, [MyFolderSection].
4. On consecutive lines in the property mapping section, list the briefcase properties that you created in step 1 and the corresponding folder property names that you want to replicate, one line per property. For each property, specify the vault property set and property name that you want to replicate. The property mapping section is independent of the folder types that are used, so map all properties that are used by all folder types that will be used for collaboration.

Use the following format for each line:

<BriefcasePropertyName>=<PropertySetName.PropertyName>,<Flag>

Unlike replicated documents, folders do not have an owner so that folder property changes can be replicated in every direction. To avoid overwriting property values, set the vault security accordingly on the folders at each site. Alternatively, at each collaborating site, configure the Flag parameter to indicate whether the folder property should be read-only (RO), read/write (RW), or write-only (WO) at that site. By default, all properties are read/write.

Following is an example property mapping section:

[Settings] 
BriefcaseSettings=GCF

[GCF]
FolderSettings=MyFolderSection

[MyFolderSection]
project_name = PSProject.Name, WO
area_name = PSArea.Test, RO